Copyright: Copyright © 1996 Wahl Enterprises


Contents
VB 32 Custom Error Builder and Tracker Add-In ver 1.0

Why Use Custom Error Builder and Tracker

Installation

How to use VB 32 Error Builder and Tracker

Registration

License Agreement


License
LICENSE AGREEMENT

VB 32 Error Builder and Tracker software, Copyright © 1996, Chuck Wahl, Wahl Enterprises, All Rights Reserved.

The latest copy of this program can be found at http://www.cwahl.com or on compuserve

Unregistered Version:

You are hereby licensed to 1) Use the unregistered Shareware version of VB 32 Error Builder and Tracker software for a 30 day evaluation period, 2) Make as many copies of the unregistered Shareware version of this software as you wish, 3) Give exact copies of the unregistered Shareware version of this Shareware to anyone, and 4 ) distribute the Shareware version in its unmodified form via electronic means.

You are specifically prohibited from charging, or requesting donations for any such copies of VB 32 Error Builder and Tracker, however made, and from distributing the software with other products (commercial or otherwise) without prior written permission.

Evaluation and Registration

VB 32 Error Builder and Tracker is NOT free software. By Installing and using VB 32 Error Builder and Tracker you agree to, within the 30 day evaluation period, register your copy of the software or quit using it. Registration and payment can be done 2 different ways. In either case Include your name and Company name, and $15.00 for each registered copy.

 1. Compuserve: GO SWREG to register via Compuserve. Choose "Register Shareware", then select(or double click) on either Title or Authors User ID. For Authors user id enter 75507,1552. For Shareware registration type 9410. Select "Display selected titles and click description. Then Register. If registering multiple copies, send EMAIL to CIS 75507,1552 and list all names and company names.

 2. Snail Mail:  Send NAME(s), Company name(s), and $15.00 in U.S. funds for each registered copy to Chuck Wahl  P.O. Box 2933, San Ramon, CA. 94583. If you would like the program sent back on floppy disk include an additional $5.00.

Use of Registered Version:

One registered copy of VB 32 Error Builder and Tracker software may either be used by a single person who uses the software personally on one or more computers. You may access the registered version through a network, provided that you have obtained individual licenses for the software covering all workstations that will access the software through the network. Upon registering the software for use over a network you will receive a special network copy.


Registration
Registration and Ordering

The latest copy of this program can be found at http://www.cwahl.com or on compuserve.

VB 32 Error Builder and Tracker is NOT free software. By Installing and using VB 32 Error Builder and Tracker, you agree to within the 30 day evaluation period, register your copy of the software or quit using it. Registration and payment can be done 2 different ways. In either case Include your name and Company name and $15.00 for each registered copy.

 1. Compuserve: GO SWREG to register via Compuserve. Choose "Register Shareware", then select(or double click) on either Title or Authors User ID. For Authors user id enter 75507,1552. For Shareware registration ID type 9410. Select "Display selected titles and click description. Then Register. If registering multiple copies, send EMAIL to CIS 75507,1552 and list all names and company names.

 2. Snail Mail:  Send NAME(s), Company name(s), and $15.00 in U.S. funds for each registered copy to Chuck Wahl  P.O. Box 2933, San Ramon, CA. 94583. If you would like the program sent back on floppy disk include an additional $5.00.

You may access the registered version through a network, provided that you have obtained individual licenses for the software covering all workstations that will access the software through the network. Upon registering the software for use over a network you will receive a special network copy.


Why use
So why use error trapping ?

When writing programs it is a must to put error trapping in all code. If you use error codes created from VB32 Error Builder you can do a few things.  You can provide yourself an easy way to trace what code (Functions, Subs, CBF's etc) caused an error. 2. If you list certain Error Code numbers in a programs help file you can provide reasons to a user as to what may be causing a problem. VB 32 Error Builder and Tracker tracks error codes between multiple programs you write, making referencing Custom Error codes easy and manageable between multiple projects.


Installation
Installation:

VB32 Error Builder and Tracker is an Add-In for Microsoft's Visual Basic 4.0 32 Bit development software.

There are 4 files in the VB32 Error Builder and Tracker zip file. Copy all 4 files to the working directory of Microsoft Visual Basic 4.0, 32 Bit program.

The files are:

VB32ErrL.exe

VB32ErrL.dll

VB32ErrL.mdb

VB32ErrL.hlp

Since VB32 Error Builder and Tracker is an OLE add-in for VB 4.0 it must be registered in the system registry. To register the Add-In:

 1 Close all instances of VB 4.0, both 32 Bit and 16 Bit.

 2 Open Explorer and locate the VB32ErrL.exe file in the working directory of VB 4.0.

 3 DOUBLE Click the VB32ErrL.exe file. It will automatically register itself as an OLE add-in.

That's all, now to use, open VB32 4.0 and from the menu click ADD-INS, then Add-In-Manager.

From the Available Add-Ins list locate "Custom Error Builder and Tracker" and click the box to the left. Click the OK button.

Now you have access to the Add-in from the VB 4.0 Add-in menu. Simply click the Add-IN menu to access the program.

Note: This is only a 32 bit Add-In. You can however use this product in 16 bit environments by simply opening VB 4.0 32 Bit to access the Add-In


How to use
Click the area of the picture where a [image] appears to see it's description or function

 To create a new Error Code for a particular project:

  1 Type in the name of the Function, Sub, or Form_Event in the Function/Sub box.

  2 Select a project from the Project box or add a new one.

     To ADD A NEW PROJECT, type it in the box and either press the enter key or the tab key. If you have one or more entries the complete list of Error Codes for that project will be listed below in the grid.

     To SELECT A CURRENT PROJECT already in the database, either type in the name  or select it from the drop down box. After typing or clicking the project Enter or Tab to view them.

  3 After you press the enter key or tab away from the Project box a new Custom Error code will be generated for the project listed in the project box. Make any changes you wish to the option buttons and when complete, click the "Save, Copy, Exit" menu. This will Save the Custom Error Code in the database, Copy the Custom Error String to the windows clipboard, and exit VB32 Error Builder and Tracker.

  4 Now where ever you want the Error Trapping (probably in the name of the routine you named in the Function/Sub box) paste the windows clipboard text. The first line of the Error Routine needs to be moved (cut and paste it) to where ever you want to error trapping to start.

To edit a current record in the database:

  1 Make sure the Function/Sub box is blank

  2 Select the name of the project in the Project box so its displayed in the project box. Double click the name or tab, enter out of the project box. You will now have all Custom Error Codes for the particular project listed below in the grid.

  You can make changes directly in the grid,

  OR

  DRAG a particular Error# from the grid and DROP it in the Error Number box located to the right of the project box. Make the changes if any and then click "Save, Copy, Exit" in the Menu to save the changes and copy to the windows clipboard.

To View the Visual Basic Error Codes, Click File then VB Errors. The first time you want to view the VB Errors you need to click Get VB Errors

If your database becomes corrupt you can click File and Compact/Repair database.


Function/Sub

 This is the name of the Function, Sub, or Form_Event you will be putting the Error trapping in. This will provide an easy way to trace back where an error is occuring in code.


Project

 These are the different projects or programs you're writting. This is how you divide all the Custom Error codes into groups so you can view a single project at a time.


Error Number

 A unique number assigned to a particular project. VB32 Custom Error Builder and Tracker starts with 32,767 and assigns numbers downward. Using unique numbers for each error trapping routine allows you to easily locate which routine is causing an error if one occurs.


Error Statement

 The line used in Code to tell VB where to go incase of an error. Normally you would put this line at the beggining of code in a Function or Sub or Form_Event. You can put multiple error trapping inside the same function/sub. At any given spot put another Error Statement.


Error Handler

 This is where the Error routine starts when an error occurs in code. Normally these lines are at the end of the code.


Message Box Message

 This is the message you will receive after an error occurs. This message will tell you and/or others where an error occurs in your code. You can reference these numbers in a help file for explanations as to what might have caused an error. These are also helpful if a person contacts you to ask why they keep getting this error number. You can easily look up the error number in your database and see where in your code the error is occurring, making debugging very easy and less time consuming.


Message Box Title

  This is the title of the Error Message box. The default is the name of the project


Error$

 This will give a more detailed explanation of the error from VB's point of view.


Error Handler Exit Statement

 Select this to indicate exiting a Function, Sub, or if you want to resume the code after the line that caused the error.


Message Box Button Types

 Select the type of buttons you want on the error message box


Message box Icon

 Select the type of Icon to be displayed on the Error message box


Message box default button

 Select the default button you want on the Error message box


System Modal message box

 Select if you want the message box to be a system modal box.


Grid

 Lists all the Custom Error Codes for a project. You can edit the values in the grid directly or DRAG and DROP the ERROR# from the grid to the forms ERROR NUMBER Box


Save Copy Exit

 Saves the changes you've made to the database, copies the Error strings to the windows clipboard, and exits VB32 Error Builder and Tracker